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OVERVIEW 


WELCOME 
Welcome to Learning to RAP, a series of tutorials 





designed to teach you how to use the Report 
Designer’s Calc Workspace to perform calculations 
and control visual aspects of the report while it is 
generating. For example you might want to calcu- 
late the number of stocks in a portfolio whose share 
price exceeds $50.00. In addition you might decide 
to conditionally display the share price of each 
stock in either black or red, depending upon 
whether its share price exceeds $50.00. 


RAP stands for Report Application Pascal and is 
used to refer to the Report Designer's Calc Work- 
space. The Calc Workspace provides an event- 
based scripting environment in which you can 
implement blocks of code that are executed in 
response to specific events that occur during the 
report generation process. 


RAP is also used to refer to the scripting language 
itself. RAP is powerful, yet easy to learn and read. 
The RAP scripting language is based upon Object 
Pascal, a modern version of the Pascal program- 
ming language that has historically been used to 
teach introductory programming courses. 


The Report Designer, shown below, is the applica- 
tion you will use to code reports. Learning to RAP 





is written for the end user who is already familiar 
with ReportBuilder. If you are unfamiliar with the 
data, design, or preview tabs, then the Learning 
ReportBuilder guide is where to start. 


ReportBuilder: New Report 
Fle Edt view Report Help 
1g bata 6B Cake [Desi 
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THE CALC WORKSPACE The Report Designer’s Calc Workspace is divided 


The Calc workspace provides an event-based into four main areas as shown in the diagram 
scripting environment that can be used to perform below. Each of these areas is covered in detail on 
calculations and dynamically control visual aspects the following pages. 


of the report layout while the report is generating. 
Scripts that respond to events are called event-han- 






























































dlers. 
ReportBuilder - rbCustomerList He&) 
File Edit view Help 
6G Data | Gy Calc | G2 Design | 3 Preview 
Report Objects _ Events for Report 
=> [E) Report B AfterAutoSearchDialogCreate 
=| bes Header _) AfterOpenD ataPipelines 
"A DBText! |) AfterPrint 
A Label! 1) BeforeAutoSearchDislogCreate 
>. (nel _) BeforeO penDataPipelines 
A Label _) BeforePrint 
A Label3 5 
‘A Labeld Q OnAssignPreviewFormSettinas 
A © dee ) OndutoSearchDialogClose 
‘A Labelé 1) OnCancel 
= Detail |) OnCancelDislogClose 
DBText2 _) OnCancelDialogCreate 
rN DBText3 L} OnEndColumn 
=A DBText4 |} OnEndFirstPass 
"A DBText5 _} OnEndPage 
EA DBText6 _} OnEndSecondPass 
“= Footer |) OnGetAutoSearchValues 
procedure ReportAfterautoSearchDialogCreate; Code Toolbox: Data 
begin ©) plCustomer D 
end; 
Fields for plCustomer 
Name 
B 
DateTime 
String 
String 
: TaxRate Double 
#2 Zip string 
C Data | Objects | Language 
A Code Explorer: Used to organize and manage C The Code Toolbox: Visual code repository, 
a report’s scripts supports drag-and-drop script creation 
B Code Editor: Used to edit scripts D Message Window: Dislays messages from 
the script compiler that checks your code 














Code Explorer 


The Code Explorer is contained in the upper left 
and right panes of the Calc workspace. 


The left pane contains a tree view - use this to nav- 
igate your report’s code. The right pane contains a 
list view - it will display a variety of items depend- 
ing on what is selected in the tree view. By right- 
clicking on the tree you can display a context menu 
that allows you to control the behavior of the Code 
Explorer. 


Views 


The Calc tab allows you to manage the report code 
using three different views. By selecting the View 

menu or by right-clicking over the white space of 

the left pane: 


* Variables 
¢ Events 
¢ Module 


The series of screen shots below illustrate how the 
same report looks with each view. 


You can select a view by using the View menu or 
by positioning the mouse over the white space of 
the left pane and pressing the right mouse button to 


display a context menu. 


Variables View 


This view allows you to see the Variables within a 
report. Variables allow you to perform calcula- 
tions. Notice that only the bands are displayed in 
the left pane. The only component visible from 
this view is the Variable. All other components in 
the report are hidden in this view. 


Report Bands Variables for Group Header[0]: Custno 
ot Header _) Variable1 
pee! GroupHeaderBand1 B Variable2 
ses Detail _) Variable3 
ot GroupFooterB and1 
fet Footer 








|\~ 
vv 








Events View 


This view displays a tree view of all components 
contained within the report. The right pane dis- 
plays any events associated with the currently 
selected component. Selecting an event will dis- 
play the event script, if one exists. 


Report Objects Events for Variable2 
=p [EB Report B® OnCale 
sd Title _) OnDrawCommandClick 
= ssa Header _) OnDrawCommandCreate 
BP Shape _} OnGetText 
A Label2 _) OnPrint 
A Label3 _) OnReset 
=A. DBText1 
=A DBText2 
Sp ¥ Groups[0] 
= be Header 
(® Variable 
a 
(® Variable3 
(® Variable4 
ate Footer 
= Detail 
= Footer < 

















Module View 


This view displays a global view of the entire calc 
module. It lists all declarations, events, programs, 
and event handlers. This view is useful when you 
want to examine all of the report’s code. 


Module View 
=) e Global F | procedure Variable20nCalc(var Value: Variant); 
== Declarations 
S Events 
we Programs 
> 4 Event Handlers 

















This view displays items, which are visible to all 
event handlers of the report: 


Declarations — These are variables and constants 
that are globally visible throughout the report. 


Events — These are, in essence, the report's events. 
In the case where the preview window is displayed, 
OnCreate and OnDestroy fire when the window is 
opened and closed, respectively. This is different 
from Report.BeforePrint and AfterPrint in that 
those methods will fire each time Report.Print is 
called. OnCreate and OnDestroy are good places 
for initialization and finalization code such as cre- 
ating and freeing objects and initializing variables. 


Programs — These are procedures and functions 
that are globally visible throughout the report and 
can therefore be called from any event handler. 


Event Handlers — These are all event handlers that 
have been implemented in the report. 


Code Toolbox 


The Code Toolbox is a visual code repository. It 
contains most of the identifiers and code elements 
that the RAP compiler recognizes. 


Notice that the Code Toolbox has three tabs: Data, 
Objects, and Language. Each tab consists of a tree- 
view and a list of identifiers. 


Data Tab 


The Data tab of the Code Toolbox displays data 
pipelines and fields, allowing you to drag and drop 
field references into the Code Editor. 


Code Toolbox: Data 

















a 
Fields for Clients 
Name Type Size| 
[Acct Nor ETE 
Hi Address 1 ‘String 20 
irth Date Date 
City String 20 
Date Open Date 
3: First Name ‘String 20 
2 Image BLOB 


#2 Interests ‘String 120 FZ 
ast Name String 20 
Objectives String 10 
Occupation ‘String 20 
2 Picture String 15 v 














Selecting a pipeline from the list will display all the 
fields in that pipeline as well as data type and size 
information for the fields. 


To insert a field value into the code editing win- 
dow, select the field and drag it into the Code Edi- 
tor. The code necessary to retrieve the field value 
from the pipeline will be generated. For example, 
dragging the 'City' field from the Code Toolbox 
pictured above would result in this code: 


Value := Clients[’City’ ] 





Objects Tab 


The Objects tab of the Code Toolbox displays 
report objects and their properties, allowing you to 
drag and drop properties into the Code Editor. 


Code Toolbox: Report Objects 
= [B Report 
(=) st Header 
i) Shapel 
A 
A Label2 
A Label3 
se Detail 


=A DBText1 
DBText2 


A Label4 


Properties for Labell 


Name Type Value i 
=: AnchorBottom 
2 AnchorLeft Boolean False 
i AnchorLeftBotto Boolean False 
i AnchorLeftTop | Boolean True 
i AnchorNone Boolean False 
2 AnchorRight Boolean False 
False 
False 
False 
a - 














] 3 





Selecting an object from the tree will display a list 
of that object's properties. 


To insert a property into the Code Editor, select the 
property and drag it into the Code Editor. The code 
necessary to retrieve the value of the property or 
call the method will be generated. For example, 
dragging the 'AutoSize' property from the Code 
Toolbox pictured above would result in the follow- 
ing code: 


Labell.AutoSize 


Language Tab 


The Language tab of the Code Toolbox displays 
RAP language elements, allowing you to drag and 
drop elements into the Code Editor. 


Code Toolbox: Language 





© Function 
Conversion 
Format 
DateTime 
Math 
Utility 
Statement 
Data Type 
Operator 
Enumerated Type 











String 
See See 
Name Definition & 
a Capitalize Function Capitalizetc trin| 
CompareText function CompareText(const 51, 


Copy function Copy(S: String; Index, ¢ 
Delete procedure Delete(var S: String; 1 — 
Insert procedure Insert(Source: String; 
Length Function Lenath(S: String): Integ 
LowerCase function LowerCase(const 5: Stri 
Pos Function Pos(Substr: String; S: Sl 
Trim Function Trim{const S: String): St 
i TrimLeft Function TrimLeFt(const S: String, y 


< i | > 














Selecting a category from the tree will display a list 
of elements for that category. 


To insert an element into the Code Editor, select 
the element and drag it to the Code Editor. The 
code necessary to reference or use the element will 
be generated. Note that when you drop an item 
such as a function call, the function's parameter list 
is provided. For instance, if you drag Copy into the 
Code Editor, it will expand as: 


Copy(S, Index, Count); 
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Code Editor 


Code appears in the Code Editor when you select 
an event in the list view of the Code Explorer or 
right-click and select New. You can create code by 
dragging and dropping code from the Code Tool- 
box, or you can write your own code. When you 
want to compile your code, just right-click over the 
white space of the Code Editor and select ‘Com- 
pile’. The window below the Code Editor will 
indicate whether or not there were any errors in 


your code. 


The Code Editor's context menu contains the fol- 


lowing items: 
New 


New has the same effect as clicking in the Code 
Editor. It is only enabled if there is no implementa- 
tion for the item currently selected in the Code 
Explorer. 


Compile 


Compile activates the RAP compiler to attempt to 
compile the current procedure and any procedures 
upon which the current one depends. 


Save 


The Calc workspace maintains an intermediate 
buffer for the Code Editor. Selecting Save will 
commit the current contents of the Code Editor to 
the buffer; it will not save the entire report. Select- 
ing Save has the same effect as navigating away 


from, and then returning to the current procedure. 


Revert 


Use Revert to replace the contents of the Code Edi- 
tor with what is currently contained in the code 
buffer. This has the effect of removing all changes 


since the last save. 


Delete 


Select Delete to remove the current procedure 
entirely. 


Message Window 


Messages from the compiler are displayed here. 
You can navigate to the location of the compiler 
error by double-clicking the error message. 





CALISTHENICS FOR RAP-ERS 


OVERVIEW 
The best way to learn about the Calc tab is by 
exploring it. So let’s build a simple report that will 


allow us to explore this new workspace. 


In this section, you will implement a simple script 
that assigns the value of the ‘Current Price’ data 
field to a Variable component. 


ReportBuilder: New Report 














68 Data Cale |G Design |{3 


[5] 








Symbol Recommendation Current Price 








smc BUY $59.63 
Tc BUY $27.50 
HS $29.00 
$8.63 

$42.50 

$56.63 


$55.63 





$68.25 





GETTING STARTED 


1 Launch the Learning ReportBuilder application. 


2 Create a new report by clicking the New Report 
icon. 
3 Inthe open Report Designer, click the Data tab. 


4 Select File | New from the menu. The New 
Items dialog will appear. 


5 Double-click the Query Wizard to begin creat- 
ing a dataview. From the list of available tables, 
double click the Master table. 


6 Select Finish. 
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7 Your dataview has now been created. 


Type 
[sy Beta Double 
[aj Co Name String 
(a) Cur Price Double 
Ga) Exchange String 
Ea Industry Integer 
Ea Outlook Integer 
Eis) Price Chg Integer 
[iy Proj Girth Double 
Gia) PE Ratio Double 
Ea Rank Double 
Ea Rating String 
Ea Remndation String 
String 
Longint 
Integer 
String 
Double 
Double 














8 Return to the Design workspace by clicking the 
Design tab. 


9 Select File | Save As. 

10 Double-click the Completed Tutorials folder. 
11 Click the New Folder icon | and name the 
folder Rap. 


12 Save the report as Quick Test RAP in Com- 
pleted Tutorials\Rap. 


BUILD THE REPORT LAYOUT 
Task 1 


Layout the Report 


1 Select Report | Footer to remove the footer band 
from the report. 


2 Place three labels in the Header band. 
3 Assign the following captions to the labels: 


Labell Symbol 

Label2 Recommendation 

Label3 ~— Current Price 
4 Select the labels by shift-clicking, and select the 
Align Top icon on the Align or Space Toolbar. 
5 Set the font of the Labels by shift-clicking: 


Font = Arial 

Size 14 pt. 

Weight Bold 

Color Gray 
6 Right-click and select Position to set the follow- 
ing label positions: 

Label 1 Left: 0.0729 

Label 2 Left: 1.0208 

Label 3 Left: 3.0104 


7 Place a Shape in the Header band. 


8 Right-click the shape and select ParentHeight 
and Parent Width. 





9 Now, right-click the shape and select Send to 
Back 


10 Place two DBText components in the 
Detail band. 
11 Connect DBText1 to the ‘Symbol’ data field . 


12 Connect DBText2 to the ‘Recommendation’ 
data field. 


13 Select the DBText components by shift-click- 


ing, and select the Align Top icon on the Align 
or Space Toolbar. 


14 Shift-click Labell and DBText1 and select 
Align Left from the Align or Space Toolbar. 
15 Now select Align Left for Label2 and DBText2. 
16 Set the font for the DBText components: 

Font = Arial 

Size 14 pt. 

Weight Bold 

Color Black 
17 Set DBText1 to Italic 
18 Right-click the DBText components and select 


AutoSize. 


19 Place a Variable El to the right of the DBText 
components in the Detail band. 


20 Set the variable to right-justified. 


21 Now select Align Right [1] for Label3 and 
Variable. 






































22 Set the font of Variablel to Red. 


23 Set the data type of the Variable to Double in 
the data type drop-down list. 


24 Set Variable! TextAlignment to right justify. 
25 Select Label3, shift-click to select Variable1 


and select Align Right [a1] from the Align or 
Space Toolbar. 
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26 Right-click Variable! and select Calculations. 32 Preview the Report. 
The Calculations Dialog is displayed. 


ReportBuilder: New Report 


Calculations 














3 Preview 


Code Toolbox: Data 
r= Master['Cur Price']| 3 Master 














Fields for Master 








Symbol Recommendation Current Price 


smc BUY $59.63 


Integer 
Integer 
Double 
Integer 
ee Te BUY $27.50 
Double 
String 
String 
#! Recordid Longint 
3 Risk String 


HS HOLD $29.00 











SELL $8.63 








SELL $42.50 


Note: The Cale Dialog provides a short-cut to SELL $56.63 
implementing a Variable’s OnCalc event. The HOLD $55.63 
Code Editor appears on the left and the Code Tool- 
box on the right. 


SELL $68.25 








27 In the Data Tab of the Code Toolbox, select the 
‘Cur_ Price’ field and drag the selection to the Code 33 Save the report. 


Editor. This will result in the following code: 
34 Close the report. 


Value := Master['Cur Price']; . ; 
Congratulations! You have just completed your 


28 Press the right mouse button while positioned first report using RAP. 
over the Code Editor and select Compile from the 


context menu. 
29 Press Ok to close the Calc dialog. 


30 Right-click the Variable and select Display For- 


mat. 


31 Set the display format of the variable to 
$#,0.00;($#,0.00) so that the variable will be dis- 
payed with a dollar sign and decimal point with 
two decimal places. 





EXPLORING THE CALC WORKSPACE 


VIEWING THE REPORT CODE 
Now that we’ve created a report, let’s see what it 
looks like in the Calc tab. 


Task 1 


Access the Variables View 
1 Launch the Learning ReportBuilder application. 


2 Select the Completed Tutorials folder and dou- 
ble-click Quick Test RAP to open the report. 


3 Click the Calc tab to access the workspace. 


4 Right-click over the white space of the tree 
view. You have a choice of three views of the 
report. Select the Variables view. 


5 The header band is selected by default. Since it 
contains no variable components, the list view is 


empty. 


6 Select the detail band. The variable component 
we created for the detail band becomes visible in 
the list view. 

ReportBuilder: Quick Test Rap 


i File Edit View Help 
Data | Gl Cale | E Design | 3 Preview 
Lat 














Report Bands Variables for Detail 


Ss Heade PTvarate | 


bees Detail 











Cade Toolbox: Data 
Value := Master['Cur Price']: i Master 


Fields for Master 





String 
Double 
string 
Integer 
Integer 
Double 
Integer 
#1 Proj Grth Double 
<3)(iil) = Rank Double gy 








{ Compile Completed: 0 Errors < > 


[pata] objects | Language 








Task 2 


Access the Events View 


1 Right-click over the white space for the tree 
view and select Events. A view of the report 
appears as shown below: 


| ReportBuilder: Quick Test Rap 
i File Edit View Help 
6 Data | GB Cale | & Design | (3 Preview 
Report Objects Events for Report 
ae __] AfterAutoSearchDialoaCreate 
# Header |} AfterO pend ataPipelines 
= pss Detail L) AfterPrint 
oe DBText! |) BeforedutoSearchDialoaCreate 
"A DBText2 L} BeforeDipenD ataPipelines 
+ Veistie! ) BeforePrint 
LL} OndssignPreviewFormSettings 
|) OndutoSearchDialagClose 
L) OnCancel 




















Code Toolbox: Data 
© Master 


Fields for Master 
Name Type fe] 
String 
Double 
String 
Integer 
Integer 
Double 
Integer 
28 Proj Grth Double 
# Rank Double 
< a) 


|\[ostal objects | uenquegeT | 














Note: The list view contains events for each com- 
ponent and band. 
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2 Select the Variablel component in the Code 
Explorer’s Tree View. The events for Variable 
are displayed. 


3 Select the OnCalc event from the Code 
Explorer’s List View. The procedure for 
Variable1’s OnCalc event is displayed. 


i File Edit view Help 
eG Data | BB) Calc | & Design | LA, Preview 














Report Objects Events for Variable! 
=> f Report B OnCale 

Sm Header L} OnDrawCommandClick 

= pss Detail _} OnDrawCommandCreate 





A DBTextt 2) OnGetText 
DBT ste _} OnPrint 
B _} OnReset 








procedure VariableiOnCalc(var Value: Variant); Code Toolbox: Data 
begin © Master 


Value := Master['Cur Price']; 


Type 


String 
Double 
String 

Integer 
Integer 
Double 
Integer 
Double 
<3 Gill} EE Double 

















Compile Completed: 0 Errors ] > 


[peta | objects | Language 





end; Fields for Master 


a 


¥ 











Task 3 


Access the Module View 


1 Right-click over the white space of the tree 


view. 


2 Select Module. A list of declarations, events, 
and programs appears below the Global tree node, 
and Event Handlers appears as another tree node. 


3 Select Event Handlers. A procedure for the vari- 
able in the detail band appears in the list view and 
code for the event handler appears in the code edi- 
tor. 


ReportBuilder: Quick Test Rap 
File Edit view Help 

eG Data | (Calc |S Design | [3 Preview 
Module View 


= @ Global 
== Declarations 
@ Events 
se Programs 


> > ERE es 

















B procedure Variable! OnCalc{var Value: Variant): 





procedure Yariable10nCalc (var Value: Variant): Code Toolbox: Data 
begin © Master 


Value := Master['Cur Price']; 


end; Fields for Master 


Name Tye 





string 
Double 
string 
Integer 
Integer 
Double 
Integer 
Double 

< # Double 


Data| Objects | Language 








Compile Completed: 0 Errors 
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BROWSE THE CODE TOOLBOX 
Task 1 


Browse the Data Tab 


1 Place your cursor over the line to the left of the 
code toolbox. 


2 Drag the line to the left until you can see the 
‘Size’ section of the field discription. 
ReportBuilder: Quick Test Rap 


File Edit View Help 
68 Data | GB) Calc |S Design | [3 Preview 














Module View 

= @ Global 1B procedure Variable OnCale{var Value: Variant): 
== Declarations 
@ Events 
wa Programs 


> > REMEGeS 








procedure Variablei0nCalc(var Value: Variant); Code Toolbox: Data 
begin Bi Master 


Value := Master['Cur Price']; 


end; Fields for Master 
Name Type is) 


# Beta 
Co Name string 
#2 Cur Price Double 
#1 Exchange String 
Industry Integer 
#2 Outlook Integer 
= PE Ratio Double 
#3 Price Chg Integer 
# Proj Grth Double 
<3) Rank Double «gi 
] > 


< 
T[osta] objects | LenquogeT | 














Compile Completed: 0 Errors 





3 Make sure that all of the fields are visible. If 
they are not, you’ll need to resize the designer by 
placing your cursor over the right corner of the 
designer. Once it turns into a double-sided arrow, 
you can increase the size of the designer by drag- 
ging down: 


Note: The Data tab shows all of the fields in the 
report. Master is the name of the dataset from 
which these fields were taken. 





TASK 2 
Browse the Objects Tab 


4 Click the Objects tab of the Code Toolbox. 
5 Select the line to the left of the Code Toolbox. 


6 Drag the line to the left of until you can see the 
‘Read Only’ section of the field description. 


Note: The Objects tab displays all of the objects 
(bands, components) for the report in the top pane 
and all of the properties for the selected object in 
the bottom pane. 


7 Drag the line that divides the two panes in the 
Code Toolbox up and down. You can choose how 
much of one pane you want to see by dragging this 


line. 


8 Select the header in the code toolbox: 


Code Toolbox: Report Objects 
& Report 


-— 
Shapel 
A Label! 
A Label2 
A Label3 
=) Detail 
= DBTextl 
EA DBText2 
(@ Variable1 





Properties for Header 


Name Type ReadOnly « 
[:Assign __ | SEE SESE ea 
#i BottomOffset Single 
ClassName Method 





Function ClassNarr True 











Count Integer 0 True 

Create Constructor constructor Creat: True 

Free Method procedure Free = True 

Height Single 0.52079999 

Name String ppHeaderBand1 

ObjectCount _ Integer 4 True 7 

Objects Array Objects[Index:Int True 

OverFlow Boolean False True 

Owner TComponent 

PrintHeight TppPrintHeightT yp phStatic 

PrintOnFirstPage Boolean True 

PrintOnLastPage Boolean True 

PrintPosition Single in) 

Report TppCustomReport Report a 

Save Boolean False 

Tag Integer 0 
#i VariahleCount — Tntener n Trin bd 
S$ | 2 





A different set of properties appears. 
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TASK 3 
Browse the Language Tab 


1 Click the Language tab. This tab contains code 
that you can drag into the Code Editor and use as 
part of your code. 


LEARN ABOUT TYPES OF EVENTS 
1 Select the report in the tree view of the Code 
Explorer. 


Note: The right pane of the Code explorer is cur- 
rently titled ‘Events for Report’ because the Report 
object is selected. This pane shows all of the possi- 
ble events for the components of the Report object. 
The left pane is labeled ‘Report Objects’ when the 
events view is selected. This pane offers a tree 
view of all of the objects, or components, in the 
report. 


2 Select the header band. The events for the 
header band are displayed in the right pane, which 
is now labeled Events for Header. 


3 Now select the detail band. The same set of 
events appears in the right pane. All bands have 


the same events. 


4 Select a label. Now the right pane reads Events 
for Label. 


5 Select another label. The same events appear. 
Each component has a specific set of events. 


The events for each of the components and bands 
are codeable, which means that if you inserted 
code for the OnPrint event of the label, that code 
would execute when the label printed. Let’s try 


coding such an event right now! 





EVENT CREATION 

Scenario: You want the font of in the design work- 
space to be smaller so that you can fit all of the 
components in the report layout, but when you 
print, you want the font to be more readable. In 
order to accomplish this task, we’ ll create an 
OnPrint event that will change the font size. 


Task 1 


Create an OnPrint Event 
1 Select Labell in the tree view. 


2 Right-click over the OnPrint event in the list 


view and select new: 


Report Objects Events for Label 
& > (Bi Report _) OnDrawCommandClick 
f=} td Header _) OnDrawCommandCreate 
® a _) OnGetText 
abel [ 
A Label2 oS 
A Label3 
pias Detail 
A DBTextl 
DBText2 
> @ Variablet 











A procedure will appear with the name of the label 
(Labell) and the name of the event (OnPrint). A 
shell, which is a begin and end statement, will also 
appear: 


ReportBuilder: Quick Test Rap 
i File Edit View Help: 
68 Data |B Calc | Gi Design | (3, Preview 
Repott Objecte Events for Labell 


=> [EB Report (3 OnDrawCommandClick 
=) bis Header _} OnDrawCommandCreate 
$B Shapet L} OnGetText 
>A Labell BB onPiint 
A Label? 

















A Label3 
= bse Detail 


DBText1 
DBText2 


> Veriablet 








procedure LabeliOnPrint; Code Toolbox: Report Objects 
begin [Bi Report 

= se Header 

end; WD Shapet 

A Label! 





A Label2 

A Label3 
se Detail 

A DBTextl 

A DBText2 

B® Variable1 


Properties tor Header 
Name Type Value Read Only 
#2 Assign ign(|True 
#2 BottomOffset | Single 0 
ClassName | Method function ClassNam True 
‘Count Integer Q True 
#3 Create Constructor constructor Creat» True 
Free Method procedure Free True 




















Heit Sinale n.52079999 
< 














Data [Objects | Language 
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3 Type the following code beneath the begin state- 
ment: 

procedure LabellOnPrint; 

begin 


Labell.Font.Size := 14; 
end; 


You’ve just written your first line of code. Let’s 
take a moment to break it down. 


Labell.Font.Size := 14; 


A B C DE 


A Label] is the name of the label. The ‘.’ After the 
label is called a member operator, or a dot opera- 


tor. It separates each of the properties that describe 
the label. 


B Font refers to the typeface of the characters. The 
member operator serves the same function as the 


one after Labell. 


C Size describes how big the font is going to be. In 
this case, we want it to be 14 pt. 


D This is an assignment operator. It assigns the 
value 14 to the size of the font for the label. 


E 14 is the value being assigned to the font size. 
The semicolon signifies the end of the statement. 


4 Right-click over the code editor and select com- 
pile: 


ReportBuilder: Quick Test Rap 
File Edt View Help 





88 Data | Hl Calc | Li Design | |) Preview 
Report Objects Events for Label 
= b [Report } OnDrawCommandClick 
= pss Header ) OnDrawCommandCreate 
$B Shapet |) OnGetText 
>A et B OnPrint 
A Label2 
A Label? 
> Detail 
Ah DBTextl 
©A DBText2 
> Variable! 

















procedure Labeli0nPrint; Code Toolbox: Report Objects 

begin & [B Report 
Labell.Font.Size := 14; = = Header 

end; BD Shapet 
; A Labelt 

jj A Label 

12) Compile A Label 

= sm Detail 

t Si = 

el sve A eText 

4) Revert © DBText2 


X) belete B Vaiieblet 





























Properties for Header 





Name. Type ReadOnly =“) 





Assign 
BottomOffset | Single 

ClassName Method function ClassNam True 
‘Count Integer 0 True 
Create Constructor constructor Creat: True 
Free Method procedure Free True 
Heinht Sinnle .5279999 





























Data Lobiects | Language 








The triangles in the tree view and the paper icon in 
the list view should turn green: 


The window below the code editor should read 
‘Compile Completed: 0 Errors’: 





ee Completed: 0 Errors 


5 Preview. The font for the Labell component is 
now size 14 pt. 





Task 2 


Set Font Size for all Labels 

1 Access the Calc workspace 

2 Select the code for the OnPrint event. 

3 Copy the code into your clipboard (Ctrl + C). 


4 Right-click over the OnPrint event in the list 
view an select Delete: 


ReportBuilder: Quick Test Rap 


2 File Edit View Help 
68 Data Cale | G7 Design | (3, Preview 














Report Objects Events for Labell 





> IB Report () OnDrawCommandClick 
i= pe Header _) OnDrawCommandCreate 
 Shapet \) OnGetText 
>A Labell 
A Label2 
A Label 
= pee Detail 
A DBTextt 
FA DBText2 
> Variablet 


Compile 


























procedure LabeliOnPrint; Code Toolbox: Repott Objects 





begin & EB Report 
Labell.Font.Size := 14; == Header 

end; BB Shapet 
A Labelt 
A Label? 
A Label 

= Detail 
© DBTexti 
=A DBText2 
Variable1 


Propetties for Header 





Name Type 

4 Assign, 

#8 BottomOffset Single 

8 ClassName | Method Function ClassNarr True 

#4 Count Integer 0 True 

Create Constructor constructor Creat: True 
Free ‘Method procedure Free True 

pk Sinale .52079999 











iia) 
/ Compile Completed: 0 Errors 

















Data [Objects | Language 
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5 Select the Header band in the tree view. 


6 Right-click over the BeforeGenerate event and 


select new. 
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7 Paste the line of code you cut from the OnPrint 
event under the begin statement: 


Labell.Font.Size := 14; 


Note: We could have used the OnPrint event for 
Labell to execute this task; however, because we 
are going to write code for each label in the header 
band, it’s best if that band contains the code. 


8 Press the Enter key and paste the line of code 
until you have a line for each of the labels. The 
code editor should look like this: 


ReportBuilder: Quick Test Rap 
| File Edit view Help 
88 Data | BB) Calc | Design | 3, Preview 
Report Objects Events for Header 
> [FE Report _) AtterGenerate 
= bess Header _) AfterPrint 
$B Shapet | BB BeforeGenerate 
A Label! |) BeforePrint 
A Label? 
A Label3 
= ps Detail 
DBTextt 
‘A, DBText2 


> BB Variablet 























procedure HeaderBeforeGenerate; Code Toolbox: Report Objects 
begin & EB Report 
Labell.Font.Size := 14; = = Header 
Labeli.Font.Size := 14; $B Shapet 
Labeli.Font.Size := 14; | A Label! 
end; A Label? 
A Label 
= Detail 
=A DBTextl 
=A DBText2 
Variable 


Properties for Header 
Name Type 


2 Assign 
2 BottomOffset | Single 

















1 ClassName | Method Function ClassNamr True 
# Count Integer 0 True 
Create Constructor constructor Creat True 
2 Free ‘Method procedure Free True 

a Sinale f.52n79999 




















Data [Objects | Language 
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Task 3 


Update and Preview 


1 Change the code as shown below: 





Label3.Font.Size := 14; 
Label2.Font.Size := 14; 
Labell.Font.Size := 14; 


2 Compile and preview. The report should look 
like this: 


ReportBuilder: Quick Test Rap 
5 File Edit View Help 
58 Data |B Cale | Gi Design [3 Preview | 
He mes! fe 








Symbol Recommendation Current Price 





smc BUY $59.63 
Tc BUY $27.50 
HOLD $29.00 


SELL $8.63 








Save the report as Calisthenics in Completed Tuto- 
rials\Rap. 


RAP TUTORIALS 


CONFIGURING REPORT COMPONENTS 
CALCULATIONS 


GLOBAL DECLARATIONS, OBJECTS, & PROGRAMS 


CONFIGURING REPORT COMPONENTS 


Concatenation 27 
Set Font Color & Style 31 
Load Address Lines Into Memo 35 


Print Description of AutoSearch Criteria 39 
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CONFIGURING REPORT COMPONENTS 


CONCATENATION 


OVERVIEW 

This tutorial will show you how to do the follow- 

ing: 

* Create a basic report at design-time 

¢ Create a report that contains a RAP event handler 
attached to the BeforeGenerate event of the 
DetailBand. The event handler concatenates the 


first name and last name of a contact and assigns 


the result to the caption of a label. 


| ReportBuilder: New Report 

















58 Data | BH Calc | @ Design |[ 
LG 


He Net eh 





First Name Last Name First Name + Last Name 
Jennifer Davis Jennifer Davis 
Arthur Jones Arthur Jones 
Debra Parker Debra Parker 


Dave Sawyer Dave Sawyer 


Cindy White Cindy White 








Task 1 


Create a New Application 
1 Launch the Learning ReportBuilder application. 
2 Create a new report by clicking the New Report 


icon. 


3 In the opened Report Designer, click the Data 
tab. 


4 Select File | New from the menu. The New 
Items dialog will appear. 


5 Double-click the Query Wizard to begin creat- 
ing a dataview. From the list of available tables, 
double click the Clients table. 


6 Select the Finish button. 
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BUILD THE REPORT 
Task 2 


Layout the Report 
1 Click the Design tab and turn off the report’s 


footer band by selecting Report | Footer from the 
Report menu. 


2 Add three labels to the Header band. 
3 Assign the following captions to the labels: 
Labell First Name 
Label2 Last Name 
Label3 First Name + Last Name 
4 Select the labels by shift-clicking, and then use 
the format toolbar to set the following properties: 
Font = Arial 
Size 14 
Weight Bold 
Color Gray 
5 Right-click and select Position to set the follow- 
ing label positions: 
Label 1 Left: 0.5 
Label 2 Left: 2.0 
Label 3 Left: 3.5 
6 Select the labels by shift-clicking, and select the 


Align Top icon on the Align or Space Toolbar. 


7 Place a Shape in the Header band. 


8 Right-click the shape and select ParentHeight 
and ParentWidth. 


9 Now, right-click the shape and select Send to 
Back. 


10 Add two DBText controls A to the Detail 
band. 


11 Set the font color of the DBText components to 
Black and the font to Arial 14 Bold. 


12 Click on DBText1 and use the Data Field drop 
down list to select First Name. 


” Header 
First Name: 


* Detail 


Last Name 


layout check 


13 Click on DBText2 and use the Data Field drop 
down list to select Last Name. If you preview the 
report now, you should see five detail records with 
first and last names displayed. 


ReportBuilder: New Report Oe 
Fle Edt 























First Name Last Name First Name + Last Name 
Jennifer Davis 

Arthur Jones 

Debra Parker 

Dave Sawyer 


Cindy White 











14 Place one Label component to the right of 
the DBText components in the detail band. The 
Label will display the concatenated fields. 


15 Set the font color of the Label to Red and the 
font to Arial 14 Bold. 


” Header 


First Name 


* Detail 


layout check 


16 Select all of the components in the Detail band 


by shift-clicking, and select the Align Top icon iff 
on the Align or Space Toolbar. 


17 Shift-click Labell and DBText1. 


18 Select Align Left from the Align or Space Tool- 
bar. Do the same for Label2 & DBText 2, and 
Label3 & Label4. 


Task 3 


Navigate the Calc Workspace 


We will use the BeforeGenerate Event of the Detail 
band to concatenate the two fields. 


1 Click the Calc tab to display the Calc Work- 
space. 


2 Right-click the Code Explorer’s tree view and 
select Events. 


3 Click the Detail Band. 


4 Right-click the BeforeGenerate event and select 
New. 


ReportBuilder: New Report 
1 File Edit View Help 
8 Data | Gi Cale | C Design | [3 














Report Objects Events for Detail 

[3 | AtterGenerate 
L) AfterPrint 
QO 


O New 
J 











i = 























Code Toolbox, Report Objects 








= |L 

——) Propeties for Header 
_—__-_- 

| ata [objects | Language 
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ADD THE CODE 
Task 4 


Add the Concatenation Code 


The Data tab of the Code Toolbox should be active, 
if it is not, select it. In the upper window of the 
Code Toolbox, you should see the pipeline we 
have added, Clients. Below that, you should see an 
entry for each field in the pipeline. These items are 
draggable. 


We’re going to enter the following line of code, but 
we are going to construct it via drag and drop. See 
the DetailBeforeGenerate Event code on the next 
page. 


1 Place your cursor after the Begin line in the 
Code Editor and enter the following code: 


Label4.Caption := 
2 Click on the First Name entry in the Toolbox 
and drag it to the Code Editor, just to the right of 
the "Label4.Caption := " line. 


2 Drag the Last Name entry to the right of the line 
of code. 





3 Type in the remaining characters of the line as 


shown below. 


procedure DetailBeforeGenerate; 
begin 





Label4.Caption := Clients['FIRST NAM 
end; 





Gl 
+ 


' ' + Clients ['LAST NAM 





Fl 
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PREVIEW AND FINISH 
Task 5 


Compile and Preview 


1 To compile your code, right-click in white space 
of the Code Editor and select Compile. 





procedure DetailBeforeGenerate; 
begin 

Label4.Caption := Clients['First Name'] + ' ' + Clients['Last Name']; 
end; 





jj ‘New 
2 Compile 
ih save 


)) Revert 























XK Delete 








2 To view the results, click the Preview tab. 


ReportBuilder: New Report 


Edt View Report Help 














8§ Data Cale |G Design | Preview 


He Wee] re re 


First Name Last Name First Name + Last Name 
Jennifer Davis Jennifer Davis 
Arthur Jones Arthur Jones 
Debra Parker Debra Parker 
Dave Sawyer Dave Sawyer 


Cindy White Cindy White 











Congratulations--you’ ve successfully concatenated 
database fields using RAP! 


Task 6 
Save the Report 


1 Click on the Design tab and select Save As from 
the File menu. 


2 Navigate to the Completed Tutorials/Rap folder 
and save the report as Concatenation 


Note that the RAP Code, the DataView, and the 
report layout have all been saved together. 


3 Select File | Close to close the report. 





SET FONT COLOR AND STYLE 


OVERVIEW 
This report contains a RAP event handler attached 
to the BeforeGenerate event of the DetailBand. 


The event handler color codes the font of a DBText 
component assigned to the Price Change field. 
When the Price Change is negative, the value is 


shown in red. 
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BUILD THE REPORT 
Task 1 


Create a new report 


1 Launch the Learning ReportBuilder application. 
2 Create a new report by clicking the New Report 
[O] icon. 

3 Inthe open Report Designer, click the Data tab. 


4 Select File | New from the menu. The New 
Items dialog will appear. 


5 Double-click the Query Wizard to begin creat- 
ing a dataview. From the list of available tables, 
double click the Master table. 


6 Select Finish. 


7 Return to the Report Designer by clicking the 
Design tab. 


8 Select File | Save As and save the report as Set 
Color in the Completed Tutorials\Rap folder. 
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Task 2 
Layout the report 


1 Select Report | Footer to remove the footer from 
the report layout. 


2 Right-click the Detail band and set the position: 


Height 0.42 


3 Place three labels in the Header band. 
4 Assign the following captions to the labels: 


Labell Symbol 

Label2 Recommendation 

Label3 Price Change 
5 Select the labels by shift-clicking and set the 
font for the labels: 

Font Arial 

Size 14 pt. 

Weight Bold 

Color Gray 


6 Place a Shape [w] in the Header band. 
7 Right-click and select Send to Back. 
8 Right-click the shape and select ParentHeight. 


9 Right-click and select Position to set the follow- 
ing label positions: 

Label 1 Left: 0.1146 

Label 2 Left: 1.0833 

Label 3 Left: 3.0 
10 Select the labels by shift-clicking, and select the 


Align Top icon on the Align or Space Toolbar. 





11Place three DBText components in the 
Detail band. 


12 Set the value of the DBText components: 


DBTextl Symbol 
DBText2 Rcmndation 
DBText3 _—— Price Chg 





(Cn Fc PP P| 
° 





: | Symbol: Recommendation Price Change 


* Header 





layout check 


ry Symbol: Rcmndation Price Chg 


* Detail 


13 Set the font color to Black. 

14 Select Labell and then shift-click to select the 
corresponding DBText. 

15 Press the Align Left on the Align or Space 
Toolbar. Repeat for Label2 and DBText2. 


16 Select Label3 and shift-click to select DBText3. 


17 Press the Align Right on the Align or Space 
Toolbar. 


18 Set the TextAlignment for DBText3 to Aligned 
Right. 


19 Access the Cale Workspace by clicking on the 
Calc Tab. 


20 Select the BeforeGenerate event of the Detail 
Band. 





21 Right-click BeforeGenerate and select New. 25 Preview the report. Your report should look like 
this: 


ReportBuilder: Set Color 
3 File Edit View Help 
58 Data | By Calc | Design | (3, Preview 
Report Objects Events for Detail 


= [i Report ) AfterGenerate 
2) AfterPrint 





ReportBuilder: Set Color 
[E File Edt View Help 
of Data |B Cake |G Design [1 review 



































Symbol__Recommendation Price Change 




















SMC 
Tc 
HS 
DHE 
HGS 
PIN 
TSM 


ps 
EC 





Fields for Master 











ail) 
— took Integer 
Compile Completed: 0 Errors E Datin {Pete 


: a 
‘[pata| objects | Language | 





























231 








22 Enter the following code for the event handler: 





26 Close the report. 


procedure DetailBeforeGenerate; 


begin : 
Congratulations! You now know how to set the 
if Master[ ‘PRICE CHG’] > 0 then 


DBText3.Font.Color := clBlack 
else 
DBText3.Font.Color := clRed; 


font color and style of your reports using RAP. 





end; 


23 Right-click and select Compile. 


procedure DetailBeforeGenerate; 
begin 
if Master['Price Chg'] > 0 then 
DBText3.Font.Color := clBlack 
else 
DBText3.Font.Color := clRed; 





end; I 











>| 





24 Save the report. 
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LOAD ADDRESS LINES INTO MEMO 


OVERVIEW 
This tutorial will show you how to create a report 
that contains an event-handler in the OnPrint event 


of a Memo object. 


The event-handler loads address data from the 
datapipeline into the Lines of the memo. Format- 
ting is performed to suppress address lines and add 


commas where needed. 


3 File Repo Ip 

















68 Data Cale |G Design |. Previ 


iGoi re RI 











Task 1 

Create a new report 

1 Launch the Learning ReportBuilder application. 
2 Create a new report by clicking the New Report 
icon. 

3 Inthe open Report Designer, click the Data tab. 


4 Select File | New from the menu. The New 
Items dialog will appear. 


5 Double-click the Query Wizard to begin creat- 
ing a dataview. From the list of available tables, 
double click the Customer table. 


6 Select Finish. 


7 Return to the Report Designer by clicking the 
Design tab. 


8 Select File | Save As and save the report as Load 
Memo in Completed Tutorials\Rap. 
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BUILD THE REPORT 
Task 2 


Layout the report 


1 Place a Memo in the Detail band. 


2 Set the Position of the Memo by right-clicking 
the component: 

Left 0.1042 

Top 0.0147 

Width 3.4167 

Height 0.9271 


3 Drag the Detail band to the bottom of the 
Memo. 


4 Set the Highlight Color eal of the memo to 
Yellow. 


layout check 


5 Set the Font properties of the memo: 


Font Arial 
Size 14 pt. 
Weight Bold 
Color Red 


ADD THE CODE 
Task 2 


Enter the code for the event handler 


1 Access the Cale Workspace by clicking on the 
Calc Tab. 


2 Select Memol. 


3 Right-click OnPrint and select New. 





Report Objects Events for Memo 
ml aoa 
= Report |) OnDrawCommandClick 
wat Header | _) OnDrawCommandCreate 
st Detail L 





=! Footer 
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4 Enter the following code for the event handler: 5 Right-click and select Compile. 
eae 6 Preview the report. Your report should look like 
lsLine: String; this: 


lsState: String; 
1lsZIP: String; 
begin ReportBuilder: Load Memo 


¢ File Edit Wiew Report Help 
88 Data | (i Calc | L Design ||. Preview 


{clear memo} 
Memol.Lines.Clear; 




















add contact} 
lsLine := Customer['Contact']; 


Memol.Lines.Add(lsLine) ; 


add company} 
lsLine := Customer['Company']; 


Memol.Lines.Add(lsLine) ; 


add address linel 
lsLine := Customer['Addrl1']; 





if lsLine <> '' then 
Memol.Lines.Add(lsLine) ; 


{add address line2} 
lsLine := Customer['Addr2']; 








if lsLine <> '' then 
Memol.Lines.Add(lsLine) ; 
ide cies ape eis 7 Save the report. 
lsLine := Customer['City']; 
lsState := Customer['State']; 8 Close the report. 








if lsState <> '' then 


ions! 
leline <= lstine 4%. * 4 Testabes Congratulations! You have created a report that 


ee ee Te uses RAP to load address lines into a Memo. 


if lsZIP <> '' then 
lsLine := lsLine + ' ' + 1sZIP; 





Memol.Lines.Add(lsLine) ; 


{add country} 
ilsLine := Customer['Country']; 





Memol.Lines.Add(lsLine) ; 


end; 





41 


PRINT DESCRIPTION OF AUTOSEARCH CRITERIA 


OVERVIEW 
This tutorial will walk you through the following 


* Gain access to the AutoSearch field descriptions 
via RAP 


¢ Print a description of the search values specified 
for the report. 


] ReportBuilder: Print AutoSearch 








58 Data Cale |G Design 


= nee) 











Show all data where the First Name begins with J 
and the Last Name begins with D 


Jennifer Davis 








Task 1 


Create a New Report 

1 Launch the Learning ReportBuilder application. 
2 Create a new report by clicking the New Report 
icon. 

3 Inthe open Report Designer, click the Data tab. 
4 Select File | New. 


5 Select Query Designer from the New Items dia- 
log and click OK. 


6 On the Tables tab, double-click Clients. 


7 On the Fields tab, check the All Fields check- 
box. 


Next we will create search criteria... 
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Task 2 


Create Search Criteria 


1 On the Search tab, double-click First Name to 


add a criteria. 


2 For the new criteria, set Operator to "Like" and 
set Value to "J." 


3 Check the AutoSearch checkbox. 
4 Double-click Last Name to add a criteria. 


5 For this criteria, set Operator to "Like" and set 
Value to "D." 


6 Check the AutoSearch checkbox. 


7 Click the OK button in the Query Designer. 
You should now see the DataView. 


8 Click the Preview button on the DataView. You 
should see one record displayed: Jennifer Davis. 


BUILD THE REPORT 
Task 3 


Layout the Report 
1 Click the Design tab. 


2 Select File | Save As and save the report as Print 
AutoSearch in the Completed Tutorials\Rap. 


3 Turn off the Footer band by selecting Footer 
from the Report menu. 





4 Drop a Variable || in the Detail band. 


5 Set the properties of Variable1: 


Font Arial 
Size 14 pt. 
Weight Bold 
Color Black 


6 Set the position of Variable1: 


Left 0 

Top 0.25 
Width 0.8229 
Height 0.2292 


7 Drop aMemo in the Header band. 





8 Right-click the memo and set the position: 


Left 0 
Top 0 
Width 4.0208 
Height 0.5104 


9 Set the font: 


Font Arial 
Size 12 pt 

Weight Bold 
Color Black 


10 Right-click and set the Memo to Stretch — this 
will hold the AutoSearch field descriptions. 


layout check 


- Nariable1 


~  * Detail 


Task 4 
Write the Code 


1 Click the Calc tab. 


2 Right-click the Code Explorer's treeview and 
select Events. 


3 Click the Report node. 


4 Right-click the OnStartPage event in the list- 
view and select New. 


5 In the Code Editor, enter the following code 
(note that you can either type this in or drag and 
drop the code from the Code Toolbox): 





Report.GetAutoSearchDescription- 
Lines (Memol.Lines) ; 


























procedure ReportOnStartPage; Code Toolbox: Data 


begin 1 Clients 
Report .GetAutoSearchDescriptionLines (Memo1.Lines) ; 
end: 


Fields for Clients: 








< 


Compile Completed: 0 E1 











6 Right-click the OnCalc event for Variable1 and 
select New. 


7 Enter the following code into the Code Editor: 


procedure VariablelOnCalc (var Value: 
Variant); 


begin 


Value := Clients['First Name'] + ' ' + 
Clients['Last Name']; 


end; 
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PREVIEW AND FINISH 
Task 5 


Compile and Preview 


1 To compile your code, right-click on the Code 
Editor and select Compile. 


2 To view the results, click the Preview tab. 


ReportBuilder: Print AutoSearch 














6G Data | BB Calc | [# Design |. Preview 


= Wet) fe f= 





Show all data where the First Name begins with J 
and the Last Name begins with D 


Jennifer Davis 








3 Save the report as Print AutoSearch in Com- 
pleted Tutorials\Rap. 


4 Close the report. 


Congratulations! You should see a description of 
the AutoSearch fields in the Memo. 


CALCULATIONS 


Conditional Group Totals 45 
Conditional Grand Totals 49 


Calculations 





CALCULATIONS 


CONDITIONAL GROUP TOTALS 


OVERVIEW 
This tutorial will walk you through the following 


¢ Create an OnCalc event handler using RAP to 
count all of the Current Price values over $50.00. 


Eek) 
































BUILD THE REPORT 
Task 1 


Layout the Report 


1 Launch Learning ReportBuilder. 


2 Open the ‘Quick Test RAP’ report we created in 
the Calisthenics for RAP-ers section. 


3 Save the report as Conditional Total in Com- 
pleted Tutorials\Rap. 


Task 2 
Prepare the Data for Grouping 


1 Click the Data tab to access the Data workspace. 
2 Click the Sort icon [24] on the DataView tool 
window. 

3 Double-click Remndation and Symbol. 

4 Select Ok to exit the dialog. 

5 Return to the Design workspace. 

6 Right-click the Detail band and set the position: 


Height 0.4 
7 Select Report | Groups from the Report 


Designer menu. 


8 Select Master RCMNDATION from the drop- 
down list and press the Add button. 


9 Click OK. 
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10 Place a Label component in the Group 
Footer(0): RCMNDATION. 


11 Set the position of Label4: 


Left 0 
Top 0.1458 

12 Configure the label: 
Font Arial 
Size 14 


Weight Bold 


13 Set the Caption of the label to ‘Number of 
Stocks over $50.00 per share:’ 


14 Move Variable1 down to the Group Footer(0): 
RCMNDATION to the right of Label you just cre- 











ated. 
Sein ane lis acacia Sina ne sda amas | edi si! 
re 0 
8 - |Symbo| Recommendatior Current Pric¢ 
a ~ Header 
oe * Group Header(0): remndation 
S for agape : pias noae 
5 - Symbo  Rcmndation ‘Cur Price 
> "+ Detail 
aS 0 


- Number of Stocks over $50.00 per shat Variable: 
15 Set the text color of Variablel to Red. 
16 Set the data type to Integer. 


17 Right-click and clear the Display Format. 


18 Add a DBText component to the Detail Band 
and connect to Curr_Price field. 


19 Right-click and set the Display Format: 
$#,0.00;($#,0.00). 


20 Set the font of DBText3: 


Font Arial 
Size 14 
Color Black 
Weight Bold 
21 Shift-click Label3, DBText 3, Variablel and 


select Align Right from the Align or Space 
Toolbar. 


22 Set DBText3 TextAlignment to Right Justify. 


23 Set DBText3 Display Format to 
$#,0.00;($#,0.00). 
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ADD THE CODE 5 Click Preview to view the report. Your report 
Task 2 should appear as follows: 


Enter the code for the event handler 


ReportBuilder: Condition Total 


File Edit view Report Help 





























1 Right-click Variablel and select Calculations. 2 bata |B Cae esin [3 Preven 
ig 3 Gabe 

2 Change the code to the following: a mare 
BUY $33.75 
if (Master['Cur_ Price'] > 50) then te 
BUY $39.38 
Value := Value + 1; iy. saa 
3 . Fs BUY $15.50 
3 Right-click and select Compile. suv $1950 
BUY $108.88 
. . z 7 BUY $33.25 
4 Click OK to exit the Calculations Dialog. suv $43 


Buy $15.00 
BUY $48.00 
BUY $8.25 
BUY $40.00 
BUY $23.25 
BUY $13.75 
Buy $118.25 
BUY $24.50 
BUY $20.50 
BUY $59.63 
Buy $27.50 
BUY $16.75 
BUY $24.75 


Number of Stocks over $50.00 per share 3 








6 Save and close the report. 


Congratulations! You have created a report that 
uses RAP to calculate a conditional group total. 
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CONDITIONAL GRAND TOTALS 


OVERVIEW 

In this tutorial, you will use RAP to create an 
OnCalc event handler to count all of the Current 
Price values over $50.00. 


ReportBuilder: C:\Program Files\WBorland\Welphi7\RBuilderWemos\0. RA... [E |(E)[) 
File Edit View Report Help 
Data | Cale | Design Preview | 


a peer «ef | 





Recommendation Current Price 











BUY $42.75 
Buy $20.50 
BUY $40.00 
Buy $8.25 
BUY $108.88 
BUY $13.75 
Buy $33.25 
BUY $24.50 
Buy $19.50 
Buy $39.38 
Buy $118.25 
BUY $33.75 
Buy $24.25 
Buy $15.00 
$48.00 
Buy $23.25 
$14.00 
Buy $15.50 
$59.63 
$34.13 
$27.50 
$16.75 
$24.75 
$41.38 
$82.38 
$39.38 
$25.63 








BUILD THE REPORT 
Task 1 


Layout the Report 


1 Open Conditional Total. 


2 Select File | Save As and save the report as Con- 
ditional Grand Total in Completed Tutorials\Rap. 


3 Select Report | Summary to create a Summary 
band for the report. 


4 Move the Label and Variable from the 
Group(0): RCMNDATION to the Summary band 
by shift-clicking the components and dragging. 


5 Remove the Report Group by selecting Report | 
Groups | Delete. 





Groups | Master.Acmndation 


O):Master.Rcmndation 


(oss) 


Break On 
© Data Field © Custom Field 


On Group Change 
(J Start new page 


Reset page number 


New page when less than | 


Keep group together 


Reprint group headers on subsequent pages 
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6 Preview the report. 


7 The last page of your report should look like 
this: 


ReportBuilder: Coniditional Grand Total 











&§ Data | BB Calc |G Design |/3, Preview 
We Wes 











Recommendation Current Price 





PKC SELL $23.63 
PS SELL $29.63 
PXL ‘SELL $22.38 
SCP SELL $39.00 
SOLS SELL $13.63 
sT SELL $22.00 
™ ‘SELL $29.13 
UFD ‘SELL $9.88 
ve SELL $63.75 
WCR SELL $44.13 
WEN SELL $13.00 
WFE SELL $6.63 
wm SELL $61.50 
Number of Stocks over $50.00 per share 22 





8 Save and close the report. 


Congratulations! You have created a report that 
uses RAP to calculate a conditional grand total. 
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GLOBAL DECLARATIONS, OBJECTS, & PROGRAMS 


GLOBAL STRING 


OVERVIEW 
In this tutorial, you will learn how to use RAP to 
print the value of a global string constant. 


ReportBuilder: Global String 


File Edit View Report Hel 
68 Data | BB Calc | Design | [3 
= wes 2 


a ee] = 




















lam a global string 
lam a global string 
lam a global string 
lam a global string 


lam a global string 





BUILD THE REPORT 
Task 1 


Create a new report 


1 Launch the Learning ReportBuilder application. 
2 Create a new report by clicking the New Report 
icon. 

3 Inthe open Report Designer, click the Data tab. 


4 Select File | New from the menu. The New 
Items dialog will appear. 


5 Double-click the Query Wizard to begin creat- 
ing a dataview. From the list of available tables, 
double click the Clients table. 


6 Select Finish. 
7 Return to the Design workspace. 


8 Select File | Save As and save the report as Glo- 
bal String in Completed Tutorials\Rap. 
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Task 2 


Layout the report & enter the code for the glo- 
bal constant 


1 Place a Label in the Detail band. 


2 Select the Calc tab to enter your event handler 
code. 


3 Right-click the Code Explorer and select Mod- 
ule. 


4 Click on Declarations and declare a new con- 


stant by right-clicking Constants and selecting new. 


5 Insert the following code for the constant: 


const 


gcCaption = ‘I am a global string’; 


ADD THE CODE 
Task 3 


Enter the code for the event handler 


1 Right-click the Code Explorer and select 
Events. 


2 Create an OnPrint event handler for Labell by 
selecting Label], right-clicking OnPrint, and 
selecting New. 


3 Insert the following code for the event handler: 


procedure LabellOnPrint; 
begin 

Labell.Caption := gcCaption; 
end; 


4 Right-click and select Compile. 


5 Preview the report. Your report should look like 
this: 


ReportBuilder: Global String 














&§ Data Calc | G¥ Design || 3 


fe lee 2 





1am a global string 
lam a global string 
lam a global string 
lam a global string 


lam a global string 











6 Save and close the report. 


Congratulations! You now know how to use RAP 
to print the value of a global string constant. 
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GLOBAL STRINGLIST 


OVERVIEW 

In this tutorial, you will learn how to use RAP to 
create a program which will create, use, and then 
free a global stringlist. 


G ReportBuilder: Global String List 














le Edit View Report Help 
6G Data | BB Calc | GH Design | 3 Previe 
He We re i) 





Global StringList Item1 
Global StringList Item2 
Global StringList Item1 
Global StringList Item2 


Global StringList Item1 








BUILD THE REPORT 
Task 1 


Create a new report 


1 Launch the Learning ReportBuilder application. 
2 Create a new report by clicking the New Report 
icon. 

3 Inthe open Report Designer, click the Data tab. 


4 Select File | New from the menu. The New 
Items dialog will appear. 


5 Double-click the Query Wizard to begin creat- 
ing a dataview. From the list of available tables, 
double click the Clients table. 


6 Select Finish. 
7 Select the Design tab. 


8 Select File | Save As and save the report as Glo- 
bal String List in Completed Tutorials\Rap. 
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Task 2 


Layout the report and enter the code for the 
global string list 


1 Place a Label in the Detail band. 


2 Select the Calc tab to enter your event handler 
code. 


3 Right-click the Code Explorer and select Mod- 


ule. 


4 Click Declarations, right-click Variables and 
select New to create a new variable 


5 Insert the following code for the variable: 


var 

gStringList: TStringList; 

6 Click on Events, right-click OnCreate and select 
New. 


7 Insert the following code: 


procedure GlobalOnCreate; 
begin 
gStringList := TStringList.Create; 
gStringList.Add('Global StringList 
Iteml'); 
gStringList.Add('Global StringList 
Item2'); 








end; 
8 Now create an OnDestroy GlobalOnCreate 
event by right-clicking OnDestroy and selecting 
New. 


9 Insert the following code for the OnDestroy 


event: 


procedure GlobalOnDestroy; 
begin 
gStringList.Free; 


end; 


ADD THE CODE 

Task 3 

Insert the following code for the Label OnPrint 
event 

1 Right-click the Code Explorer and select 
Events. 


2 Create an OnPrint event handler for Labell by 
right-clicking OnPrint and selecting New. 


procedure LabellOnPrint; 
var 


liItem: Integer; 


begin 
liItem := (Detail.Count-1) mod 2; 
Labell.Caption := gStringList[lilItem]; 
end; 


3 Right-click and select Compile. 


4 Preview the report. Your report should look like 
this: 


ReportBuilder: Global String List 


i File Edit View 





5G Data | (By Calc | GH Design | 3, Preview 











He Net Os) 





Global StringList Item1 
Global StringList Item2 
Global StringList Item1 
Global StringList Item2 


Global StringList Item1 








5 Click the Design tab. 
6 Save and close your report. 


Congratulations! You now know how to use RAP 
to print the value of a global stringlist. 
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GLOBAL FUNCTION 


OVERVIEW 

This tutorial will show you how to create a pro- 
gram that creates, uses and then frees a global 
string list. A global function is used to retrieve the 
values from the global string list. 


ReportBuilder: Global Function 


5 File Edit View Report Help 











@§ Data | GB Calc | Design | Preview 








He mee) Ve =] 





Global StringList Item1 
Global StringList Item1 
Global StringList Item1 
Global StringList Item1 


Global StringList Item1 





BUILD THE REPORT 
Task 1 


Create a new report 


1 Launch the Learning ReportBuilder application. 


2 Open the Global StringList report created in the 


previous section. 


3 Select File | Save As and save the report as Glo- 
bal Function in Completed Tutorials\Rap. 
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ADD THE CODE 
Task 2 


Insert the event handler code 
1 Access the Calc workspace. 


2 Right-click the Code Explorer and select Mod- 


ule view. 


3 Click on Programs, right-click in the Code Edi- 
tor, and select New Function. 


4 Insert the following code: 


function gfGetString(aIndex: Integer): 
String; 


Result := gStringList [aIndex]; 


end; 
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PREVIEW AND FINISH 
Task 3 


1 Right-click the Code Explorer and select 
Events. 


2 Modify the OnPrint event handler for Labell. 


3 Insert the following code for the event handler: 


procedure LabellOnPrint; 
begin 

Labell.Caption := gfGetString(0); 
end; 


4 Right-click and select Compile. 


5 Preview the report. Your report should look like 
this: 


ReportBuilder: Global Function 


3 File Edit View Report Help 











a Data Cale | Gi Design || 3 Preview 








Global StringList Item1 
Global StringList Item1 
Global StringList Item1 


Global StringList Item1 


Global StringList Item1 








6 Save and close your report. 


Congratulations! You now know how to use RAP 
to print the value of a global function. 
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